home *** CD-ROM | disk | FTP | other *** search
/ Aminet 1 (Walnut Creek) / Aminet - June 1993 [Walnut Creek].iso / aminet / mus / play / playsid2_1.dms / playsid2_1.adf / PlaySID.doc < prev    next >
Text File  |  1992-12-11  |  11KB  |  322 lines
  1.  
  2.     PLAYSID V2.1        (C)1990,91,92 Håkan Sundell & Ron Birk
  3.  
  4.     Releasedate: 30th November 1992
  5.  
  6. NOTE:
  7.  
  8.     From version 2.1 of PlaySID kickstart 2.04 (v37) or above is
  9.     required! Thats becuse it make heavy use of Release 2 System
  10.     routines.
  11.  
  12.     This is SHAREWARE, not Public Domain. Thats means that if you like
  13.     this program and want further updates, you can be a registered
  14.     owner if you send us a ~$15. It also means that you can spread
  15.     this program only if all files (including this) are included, and
  16.     nothing is changed. You are not allowed to replicate any portion
  17.     of the program, both code or data. Note also that we take no
  18.     responsibilities for the use of this program considering any
  19.     damage to or failure of your hardware, software etc.
  20.  
  21.     If you just like the program please let us know so by sending
  22.     a postcard or similiar to the address below.
  23.  
  24.  
  25. NEW FEATURES:
  26.  
  27.     * Gadtools controlled workbench window
  28.     * Appwindow
  29.     * Arexx port
  30.     * Keyboard shortcuts
  31.     * Rewind Button
  32.     * Open Button
  33.     * Pause Button
  34.     * Jukebox (arexx)
  35.     * Preview (arexx)
  36.     * Faster emulation of 6502
  37.     * Faster and enhanced emulation of waveforms
  38.     * Faster emulation of ringmodulation/synchronize
  39.     * Emulation of undocumented 6502 instructions
  40.     * Enhanced Tool-type format
  41.  
  42.  
  43. PRODUCT INFO:
  44.  
  45.     This is a utility which emulates the SID and 6510 chip. The
  46.     SID chip is the component in the C64 computer that handles sound.
  47.     The 6510 chip is the CPU of the C64, that means the component
  48.     that actually executes all programs. Because the Amiga does
  49.     not have these chips and others, you can't run C64 programs
  50.     directly on Amiga.
  51.  
  52.     Now this utility lets you play all those C64 programs that
  53.     produce sound. As you probably know, the C64 has three sound
  54.     channels (the amiga has four). But this utility also allows
  55.     use of the fourth channel. This channel is the product of
  56.     some special programming on the C64, it isn't really a channel.
  57.  
  58.     The purpose of this product is to make the best conversion
  59.     of C64 sound on Amiga ever possible. If you think some sound
  60.     isn't correctly converted please let us know.
  61.  
  62.     This utility is designed to work with true multitasking, under
  63.     any system version and any amiga model. It can be run from both
  64.     Workbench and CLI/Shell. It should work with any other program
  65.     that don't use sound or timing. If this isn't the fact please
  66.     let us know.
  67.  
  68.     Some time ago we released a similar product called "The 100 most
  69.     remembered C64 game-tunes". This product is the version 2.1
  70.     of that program. The tunes on that demonstration disk are now
  71.     also available to this version. And up to date there are more
  72.     than 400 tunes available. We and others are also working with more.
  73.  
  74.  
  75. PROGRAM INSTALLATION:
  76.  
  77.     To use this utility from Workbench you should assign SID: to a 
  78.     directory containing PlaySID. Then all you have to do is to
  79.     double click on the icon of the tune you want to play. Otherwise
  80.     you could just select the icon of the tune, then press the shift
  81.     key and hold it down while double clicking on the PlaySID icon.
  82.  
  83.     If you want to run this utility from CLI/Shell, just put the
  84.     directory containing PlaySID in your path (e.g. c: ) and then
  85.     write: PlaySID [<tune directory>/<tune name>]
  86.  
  87.     PlaySID need a special font. Include playsid.font in your FONT:
  88.     directory.
  89.  
  90.     The "Setup" icon will copy the main program to RAM: and assign
  91.     it to SID:. After selecting this icon you only have to double-
  92.     click on the icon of the tune you want to play.
  93.  
  94.  
  95. PROGRAM USAGE:
  96.  
  97.     It works almost like an ordinary cassette player, with the
  98.     symbols for play, forward, rewind, pause and stop. While PlaySID
  99.     is active you can just drag a tune icon and drop it on the
  100.     PlaySID window. To most commands there are keyboard shortcuts.
  101.  
  102.     l - Play
  103.     p - Pause
  104.     s - Stop
  105.     t - Next
  106.     T - Preview
  107.     o - Open
  108.  
  109.     The menu have more options like about, open, quit, filter and
  110.     rewind.    The filter option turns on and off the amiga sound filter.
  111.     Please try it.
  112.  
  113.     If the rewind option is turned on, the rewind gadget will be
  114.     enabled first when you press the play gadget. The rewind routines
  115.     are very complex and need a lot of memory. Thats the reason of the
  116.     option. It takes approximately 30k every minute of playing.
  117.  
  118.  
  119. AREXX PORT:
  120.  
  121.     PlaySID now have an Arexx Port named 'PLAYSID'. This mean that
  122.     you now have full controll of PlaySID through your arexx scripts.
  123.     Supplied with this release are two examples of what you can do
  124.     with arexx:
  125.  
  126.     Jukebox - This will take given file as input and play each
  127.           song the amount of time given.
  128.  
  129.           Try: RX Jukebox JukeDemo
  130.  
  131.     Preview - This will play each tune in given song for 10 sec.
  132.           Like the preview found in CD Players.
  133.  
  134.           Try: RX Preview Songs/RunTheGauntlet
  135.  
  136.     Arexx commands supported:
  137.  
  138.     SID_PLAY()      - Start current tune
  139.     SID_PAUSE()      - Pause current tune
  140.     SID_STOP()      - Stop current tune
  141.     SID_QUIT()      - Quit PlaySID
  142.     SID_LOAD(song)      - Load <song> into PlaySID
  143.     SID_SETTUNE(tune) - Set <tune> to current one
  144.     SID_NUMTUNES()      - return number of tunes
  145.  
  146.  
  147. TECHNICAL INFO:
  148.  
  149.     Up to date PlaySID features:
  150.  
  151.     * Full emulation of valid 6502 instructions
  152.     * Full envelope emulation (even better than SID)
  153.     * Full waveform emulation (uses highest quality ever possible)
  154.     * Full ringmodulation/synchronize emulation (even both!)
  155.     * Emulation of the fourth channel, including Martin Galway NOISE
  156.       and all kind of SAMPLES
  157.     * Sounding like C64 PAL even on Amiga NTSC (the right sound)
  158.     * Handle 50Hz, 60Hz and variable speed timing
  159.     * Fast Forward
  160.     * Timer
  161.     * Amiga 4 kHz Filter ON/OFF (Should be off!)
  162.     * Full TRUE Multitasking (Opens, Closes and Checks everything)
  163.     * Above new feutures
  164.  
  165.     PlaySID is written with Emacs 18.58 and compiled with SAS/C 6.0
  166.     and Devpac 3.0 assembler. The user interface was designed with
  167.     Toolmaker. It uses about 50kB of chip memory and 160kB of other
  168.     memory. If playing samples or rewind option is on, more memory
  169.     will be used. Also add the length of the tune to the amount of
  170.     other memory.
  171.  
  172.  
  173. TOOL TYPE INFO:
  174.  
  175.     Syntax of the Tool-Types of <tune>.info:
  176.  
  177.        ADDRESS = <loadaddress>,<initaddress>,<playaddress> ;in hex
  178.  
  179.     loadaddress should be the C64 adress where the file should
  180.     be loaded. If 0 is specified, the first two bytes of the file
  181.     will instead be used as loadaddress.
  182.     
  183.     initaddress should point to a subroutine which initializes the
  184.     songnr in accumulator (starting with $00). If 0 is specified,
  185.     then the initaddress will be the first C64 address loaded.
  186.  
  187.     playaddress should point to a subroutine which plays a note of
  188.     the song. This will be called as often as described in the speed
  189.     parameter. If 0 is specified, then the playaddress will be the
  190.     address of the interrupt initialized by the subroutine at the
  191.     initaddress. This address will be the contents of $0314/0315 or
  192.     $FFFE/FFFF depending on what value $0001 contains.
  193.  
  194.        SONGS = <nr of songs>,[<start song nr>] ;in dec
  195.  
  196.        SPEED = <speeddata> ;in hex
  197.  
  198.     speeddata contains info about playspeed. For each song a bit
  199.     is reserved, bit 0 for song nr 1 and so on. A 0 bit means 50 Hz
  200.     and a 1 bit means 60 Hz or the time set in $DC04/05.
  201.  
  202.        NAME = <name of the tune> ;in ascii
  203.  
  204.        AUTHOR = <name of the author> ;in ascii
  205.  
  206.        COPYRIGHT = <name of the copyright owner> ;in ascii
  207.  
  208.  
  209. FUTURE FEATURES:
  210.  
  211.     This is a list of features that still isn't included into the current
  212.     version. They will probably be included in future versions.
  213.  
  214.     * Emulation of Filter.
  215.     * Option to get a window or screen with special musicinfo.
  216.     * Option to load and play Tunes which are already emulated.
  217.     * Option to Sound like C64 NTSC for American users who like NTSC.
  218.     * Option to load and show KOALA pictures.
  219.     * Option to load SID songs.
  220.     * Features YOU would like to be added (PLEASE WRITE AND TELL US).
  221.  
  222.  
  223. CONVERSION:
  224.  
  225.     If you convert by yourselve, PLEASE send them to us, using e-mail
  226.     or regular mail, so we can release complete packages. Then the
  227.     user will not get several packages with same or bad tunes.
  228.  
  229.     If you want to help us with conversion, we would be very pleased.
  230.     We have a lot of disks on 1541-format and Amiga-format with already
  231.     ripped tunes. On a lot of the files, the only work to do, is to
  232.     find the addresses of the initroutines. Some of them are splitted
  233.     in several files but the most of them are one-parted. If you don't
  234.     have a C64 anymore but still have the knowledge of 6502, we could
  235.     also supply you with a fast C64emulator with a machinecodemonitor
  236.     made by ourselves. If you would want these files, please send some
  237.     blank disks (in either format) to any address belove. If it shows
  238.     up that you are a good converter, then you will have the next
  239.     updates for free.
  240.  
  241.     For more information about conversion, read the special docs.
  242.  
  243.  
  244. REGISTRATION:
  245.  
  246.     If you want to support our work you have the option to become a
  247.     registered owner of this utility and receive further upgrades.
  248.     Send around $15 USD (US DOLLAR) or equal amount in SEK (Swedish
  249.     Krona) or DM (German Mark). Send it to eihter address below with
  250.     your name, address, e-mail etc. If you later change address,
  251.     please let us know.
  252.  
  253.         Ron Birk        Håkan Sundell
  254.         Krögarvägen 11        Gränsvägen 8
  255.         145 52 Norsborg        663 00 Skoghall
  256.         SWEDEN            SWEDEN
  257.  
  258.     If you want to phone us about suggestions or complains about
  259.     PlaySID you may call:
  260.  
  261.     +46 (0)31 7769424 (Håkan) about 6502 and SID emulation
  262.     +46 (0)8 53188626 (Ron) about User interface and Arexx
  263.  
  264.     If you have access to Internet you will reach us at the following
  265.     e-mail address:
  266.  
  267.     d89-rbi@nada.kth.se
  268.  
  269.       or
  270.  
  271.     nana-25@student.cs.chalmers.se (only available until 930121)
  272.  
  273.  
  274. NOTE TO OTHER DEVELOPERS:
  275.  
  276.     To Questronix (The makers of The A64 Package):
  277.  
  278.     We are still offering you our SID emulation to your
  279.     C64 Emulator (We have listened to your noise emulation).
  280.     And if that is interresting, we could help with the Cassette
  281.     interface (including software) too! It's connected as a diskdrive,
  282.     and it works very fine.
  283.  
  284.  
  285. THANKS:
  286.  
  287.     We want to thank the following people for helping us with the
  288.     development of PlaySID:
  289.  
  290.     Robert Eichelsheim   - For supporting us with extremely many ripped
  291.                    tunes and for information about the authors
  292.                    and copyrights. For beta testings and good
  293.                    suggestions about improvements.
  294.  
  295.     Bent Nielsen         - For supporting good ideas and algorithms
  296.                    about synthesized waveforms.
  297.  
  298.     Alexander Andelkovic - For lending us your C64, 1541 and many
  299.                    games to rip songs from.
  300.  
  301.     Stefan Boberg        - For early beta tests and good suggestions.
  302.  
  303.     Teijo Kinnunen       - For making MED! It inspired us to make
  304.                    PlaySID multitask.
  305.  
  306.     Olaf Barthel         - For making Term! Without it we would still
  307.                    use snail mail during development, as we
  308.                    live 460 km from each other.
  309.  
  310.     Registered Users     - Thanks for supporting our work. You are
  311.                    the reason for our work.
  312.  
  313.     Commodore-Amiga      - For making all this possible!
  314.  
  315.  
  316. LAST WORDS:
  317.  
  318.     We hope that you will find this program useful and that
  319.     it will bring back the old C64 athmosphere to you too...
  320.  
  321.  
  322.